home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / cmds / ps / RCS / ps.man,v < prev   
Encoding:
Text File  |  1989-08-01  |  8.3 KB  |  294 lines
  1. head     1.4;
  2. branch   ;
  3. access   ;
  4. symbols  ;
  5. locks    ; strict;
  6. comment  @@;
  7.  
  8.  
  9. 1.4
  10. date     89.07.31.17.50.52;  author douglis;  state Exp;
  11. branches ;
  12. next     1.3;
  13.  
  14. 1.3
  15. date     89.06.12.15.51.59;  author douglis;  state Exp;
  16. branches ;
  17. next     1.2;
  18.  
  19. 1.2
  20. date     88.12.30.10.09.48;  author ouster;  state Exp;
  21. branches ;
  22. next     1.1;
  23.  
  24. 1.1
  25. date     88.12.22.11.32.09;  author ouster;  state Exp;
  26. branches ;
  27. next     ;
  28.  
  29.  
  30. desc
  31. @@
  32.  
  33.  
  34. 1.4
  35. log
  36. @handle billing rates
  37. @
  38. text
  39. @' $Header: /a/newcmds/ps/RCS/ps.man,v 1.3 89/06/12 15:51:59 douglis Exp Locker: douglis $ SPRITE (Berkeley)
  40. .so \*(]ltmac.sprite
  41. .HS PS cmds
  42. .BS
  43. .SH NAME
  44. ps \- print process status information
  45. .SH SYNOPSIS
  46. \fBps \fR[\fIoption(s)\fR] [\fIpid pid\fR ...]
  47. .SH OPTIONS
  48. .IP "\fB\-a\fR" 14
  49. Print out information for processes belonging to all users (normally
  50. only the invoking user's processes are printed).
  51. .IP "\fB\-A\fR" 14
  52. Print out information for absolutely all processes, even dead ones.
  53. .IP "\fB\-d\fR" 14
  54. Print information only for processes in DEBUG state.
  55. .IP "\fB\-help\fR" 14
  56. Print out a help message and exit without doing anything else.
  57. .IP "\fB\-i\fR" 14
  58. Instead of the default status information, print information about
  59. various process ids (includes the PID, PPID, GROUP, USER, RUSER, TIME,
  60. and COMMAND fields).
  61. .IP "\fB\-k\fR" 14
  62. Print out information for kernel server processes in addition to
  63. any other processes requested with other switches.
  64. .IP "\fB\-l\fR" 14
  65. Use local information for migrated processes rather than following
  66. them to their current hosts.
  67. .IP "\fB\-m\fR" 14
  68. Print information only for processes that are
  69. migrated to or from another machine.
  70. .IP "\fB\-M\fR" 14
  71. Instead of the default status information, print information about
  72. process migration (includes the PID, STATE, FLAGS, EVENT, RNODE, RPID,
  73. and COMMAND fields).  
  74. .IP "\fB\-s\fR" 14
  75. Instead of the default status information, print information about
  76. signals (includes the PID, PENDING, HELD, IGNORE, HANDLE,
  77. and COMMAND fields).
  78. .IP "\fB\-u\fR" 14
  79. Instead of the default status information, print additional
  80. ``user-oriented'' information, including PID, %CPU, %MEM, SIZE, RSS,
  81. STATE, TIME, PRI, and COMMAND.
  82. .IP "\fB\-v\fR" 14
  83. Instead of the default status information, print virtual memory
  84. information (includes the PID, CODSZ, CODRS, HPSZ, HPRS, STKSZ, STKRS,
  85. SIZE, RSS, and COMMAND fields).
  86. .IP "\fB\-w \fIlineWidth\fR" 14
  87. Use \fIlineWidth\fR as the output line length, and format output so that
  88. it fits neatly on lines of this length.  The COMMAND field gets truncated
  89. as necessary to accomplish this. 
  90. .BE
  91.  
  92. .SH DESCRIPTION
  93. .LP
  94. This command prints out process status information.
  95. If one or more \fIpid\fR's is given, then information is printed
  96. for those processes.  If no \fIpid\fR is given, then information is
  97. printed for all processes belonging to the invoking user (additional
  98. processes may be requested with switches like \fB\-a\fR).
  99. .LP
  100. By default, \fBps\fR prints a short status report for each process, containing
  101. the PID, STATE, TIME, and COMMAND fields.  Other forms of printout are
  102. available using switches like \fB\-u\fR and \fB\-m\fR.
  103.  
  104. .SH FIELDS
  105. .LP
  106. The names of fields printed by \fBps\fR (which appear at the tops of the
  107. columns of \fBps\fR printout), and the meaning of the information printed
  108. in the fields, are:
  109. .IP \fBCODRS\fR 13
  110. The amount of physical memory occupied by this process's code
  111. segment, in units of 1024 bytes.
  112. .IP \fBCODSZ\fR 13
  113. The total size of this process's code segment, in units of 1024 bytes.
  114. Not all of this is necessarily resident in memory.
  115. .IP \fBCOMMAND\fR 13
  116. The command that the process is executing.  This field gets truncated
  117. if necessary to avoid running off the end of the line.  Use the \fB\-w\fR
  118. switch to request a longer line size when needed.
  119. .IP \fBEVENT\fR 13
  120. The \fIevent\fR field from the process control block (printed in
  121. hexadecimal).  See the include file <kernel/proc.h> for further
  122. information.
  123. .IP \fBFLAGS\fR 13
  124. The \fIgenFlags\fR field from the process control block (printed in
  125. hexadecimal).  See the include file <kernel/proc.h> for further
  126. information.
  127. .IP \fBGROUP\fR 13
  128. The process group to which this process belongs.
  129. .IP \fBHANDLE\fR 13
  130. A hexadecimal value giving a bit-mask of the signals for which the process
  131. has specified handler procedures.
  132. .IP \fBHELD\fR 13
  133. A hexadecimal value giving a bit-mask of the signals currently ``held''
  134. (prevented from being delivered to the process at its request).
  135. .IP \fBHPRS\fR 13
  136. The amount of physical memory occupied by this process's heap segment,
  137. in units of 1024 bytes.
  138. .IP \fBHPSZ\fR 13
  139. The total size of this process's heap segment, in units of 1024 bytes.
  140. .IP \fBIGNORE\fR 13
  141. A hexadecimal value giving a bit-mask of the signals currently being
  142. ignored by the process
  143. .IP \fBPID\fR 13
  144. The process ID for the process.
  145. .IP \fBPPID\fR 13
  146. The process id of the parent of this process.
  147. .IP \fBPRI\fR 13
  148. The priority of the process.  Processes with normal priority have no
  149. specific priority listed.  Server processes, with infinite priority,
  150. are listed as "S". 
  151. Processes with above-normal priority are
  152. listed
  153. as ">", and processes with below-normal priority are listed as "<".
  154. Processes with VERY_LOW_PRIORITY are listed as "<<".
  155. .IP \fBPENDING\fR 13
  156. A hexadecimal value giving a bit-mask of the signals that are awaiting
  157. delivery to the process.
  158. .IP \fBRNODE\fR 13
  159. For a migrated process, this identifies the ``other'' node that the
  160. process belongs to (its home node if this is the remote node, or
  161. vice versa).
  162. .IP \fBRPID\fR 13
  163. For a migrated process, this contains the id of the process on its
  164. ``other'' node (its home node if this is the remote node, or
  165. vice versa).
  166. .IP \fBRSS\fR 13
  167. Resident set size:  the total physical memory occupied by this
  168. process, in units of 1024 bytes.  This is the sum of CODRS, HPRS, and
  169. STKRS.
  170. .IP \fBRUSER\fR 13
  171. The name of the user corresponding to the real user ID of this process.
  172. .IP \fBSIZE\fR 13
  173. The total amount of virtual memory allocated to this process,
  174. in units of 1024 bytes.  Not all
  175. of this memory is necessary resident in physical memory, and some of it
  176. may not even have been accessed.  SIZE is equal to the sum of
  177. CODSZ, HPSZ, and STKSZ.
  178. .IP \fBSTATE\fR 13
  179. The current execution state of the process.
  180. .IP \fBSTKRS\fR 13
  181. The amount of physical memory occupied by this process's stack segment,
  182. in units of 1024 bytes.
  183. .IP \fBSTKSZ\fR 13
  184. The total size of this process's heap segment, in units of 1024 bytes.
  185. .IP \fBTIME\fR 13
  186. The total CPU time consumed by the process, in minutes and seconds.
  187. This time includes both kernel and user time.
  188. .IP \fBUSER\fR 13
  189. The user name corresponding to the effective user ID of this process.
  190. .IP \fB%CPU\fR 13
  191. A smoothed average of the fraction of a CPU that this process has
  192. consumed over the last several seconds.
  193. .IP \fB%MEM\fR 13
  194. The fraction of total physical memory occupied by this process's
  195. segments.  Does not include memory that belongs to the process
  196. but is swapped out.
  197.  
  198. .SH KEYWORDS
  199. process, status
  200. @
  201.  
  202.  
  203. 1.3
  204. log
  205. @follow migrated processes.
  206. @
  207. text
  208. @d1 1
  209. a1 1
  210. ' $Header: /a/newcmds/ps/RCS/ps.man,v 1.2 88/12/30 10:09:48 ouster Exp Locker: douglis $ SPRITE (Berkeley)
  211. d43 1
  212. a43 1
  213. STATE, TIME, and COMMAND.
  214. d109 8
  215. @
  216.  
  217.  
  218. 1.2
  219. log
  220. @More format upgrades.
  221. More format upgrades.
  222. @
  223. text
  224. @d1 1
  225. a1 1
  226. ' $Header: /a/newcmds/ps/RCS/ps.man,v 1.1 88/12/22 11:32:09 ouster Exp Locker: ouster $ SPRITE (Berkeley)
  227. d26 3
  228. d30 3
  229. d35 1
  230. a35 2
  231. and COMMAND fields).  Print information only for processes that are
  232. migrated to or from another machine.
  233. @
  234.  
  235.  
  236. 1.1
  237. log
  238. @Initial revision
  239. @
  240. text
  241. @d1 1
  242. a1 1
  243. ' $Header: /sprite/doc/ref/cmds/RCS/ps,v 1.3 88/10/17 17:41:48 douglis Exp $ SPRITE (Berkeley)
  244. d10 1
  245. a10 1
  246. .IP "\fB-a\fR" 14
  247. d13 1
  248. a13 1
  249. .IP "\fB-A\fR" 14
  250. d15 1
  251. a15 1
  252. .IP "\fB-d\fR" 14
  253. d17 1
  254. a17 1
  255. .IP "\fB-help\fR" 14
  256. d19 1
  257. a19 1
  258. .IP "\fB-i\fR" 14
  259. d23 1
  260. a23 1
  261. .IP "\fB-k\fR" 14
  262. d26 1
  263. a26 1
  264. .IP "\fB-m\fR" 14
  265. d31 1
  266. a31 1
  267. .IP "\fB-s\fR" 14
  268. d35 1
  269. a35 1
  270. .IP "\fB-u\fR" 14
  271. d39 1
  272. a39 1
  273. .IP "\fB-v\fR" 14
  274. d43 1
  275. a43 1
  276. .IP "\fB-w \fIlineWidth\fR" 14
  277. d55 1
  278. a55 1
  279. processes may be requested with switches like \fB-a\fR).
  280. d57 1
  281. a57 1
  282. By default, Ps prints a short status report for each process, containing
  283. d59 1
  284. a59 1
  285. available using switches like \fB-u\fR and \fB-m\fR.
  286. d63 2
  287. a64 2
  288. The names of fields printed by Ps (which appear at the tops of the
  289. columns of Ps printout), and the meaning of the information printed
  290. d74 1
  291. a74 1
  292. if necessary to avoid running off the end of the line.  Use the \fB-w\fR
  293. @
  294.